home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / getnetent.0 < prev    next >
Text File  |  1996-09-02  |  4KB  |  83 lines
  1.  
  2. GETNETENT(3)               UNIX Programmer's Manual               GETNETENT(3)
  3.  
  4. NNAAMMEE
  5.      ggeettnneetteenntt, ggeettnneettbbyyaaddddrr, ggeettnneettbbyynnaammee, sseettnneetteenntt, eennddnneetteenntt - get network
  6.      entry
  7.  
  8. SSYYNNOOPPSSIISS
  9.      ##iinncclluuddee <<nneettddbb..hh>>
  10.  
  11.      _s_t_r_u_c_t _n_e_t_e_n_t _*
  12.      ggeettnneetteenntt()
  13.  
  14.      _s_t_r_u_c_t _n_e_t_e_n_t _*
  15.      ggeettnneettbbyynnaammee(_c_h_a_r _*_n_a_m_e)
  16.  
  17.      _s_t_r_u_c_t _n_e_t_e_n_t _*
  18.      ggeettnneettbbyyaaddddrr(_l_o_n_g _n_e_t, _i_n_t _t_y_p_e)
  19.  
  20.      sseettnneetteenntt(_i_n_t _s_t_a_y_o_p_e_n)
  21.  
  22.      eennddnneetteenntt()
  23.  
  24. DDEESSCCRRIIPPTTIIOONN
  25.      The ggeettnneetteenntt(), ggeettnneettbbyynnaammee(), and ggeettnneettbbyyaaddddrr() functions each return
  26.      a pointer to an object with the following structure containing the bro-
  27.      ken-out fields of a line in the network data base, _/_e_t_c_/_n_e_t_w_o_r_k_s.
  28.  
  29.            struct  netent {
  30.                    char            *n_name;        /* official name of net */
  31.                    char            **n_aliases;    /* alias list */
  32.                    int             n_addrtype;     /* net number type */
  33.                    unsigned long   n_net;          /* net number */
  34.            };
  35.  
  36.      The members of this structure are:
  37.  
  38.      _n___n_a_m_e      The official name of the network.
  39.  
  40.      _n___a_l_i_a_s_e_s   A zero terminated list of alternate names for the network.
  41.  
  42.      _n___a_d_d_r_t_y_p_e  The type of the network number returned; currently only
  43.                  AF_INET.
  44.  
  45.      _n___n_e_t       The network number.  Network numbers are returned in machine
  46.                  byte order.
  47.  
  48.      The ggeettnneetteenntt() function reads the next line of the file, opening the
  49.      file if necessary.
  50.  
  51.      The sseettnneetteenntt() function opens and rewinds the file.  If the _s_t_a_y_o_p_e_n
  52.      flag is non-zero, the net data base will not be closed after each call to
  53.      ggeettnneettbbyynnaammee() or ggeettnneettbbyyaaddddrr().
  54.  
  55.      The eennddnneetteenntt() function closes the file.
  56.  
  57.      The ggeettnneettbbyynnaammee() function and ggeettnneettbbyyaaddddrr() sequentially search from
  58.      the beginning of the file until a matching net name or net address and
  59.      type is found, or until EOF is encountered.  Network numbers are supplied
  60.      in host order.
  61.  
  62. FFIILLEESS
  63.      /etc/networks
  64.  
  65. DDIIAAGGNNOOSSTTIICCSS
  66.      Null pointer (0) returned on EOF or error.
  67.  
  68. SSEEEE AALLSSOO
  69.      networks(5)
  70.  
  71. HHIISSTTOORRYY
  72.      The ggeettnneetteenntt(), ggeettnneettbbyyaaddddrr(), ggeettnneettbbyynnaammee(), sseettnneetteenntt(), and
  73.      eennddnneetteenntt() functions appeared in 4.2BSD.
  74.  
  75. BBUUGGSS
  76.      The data space used by these functions is static; if future use requires
  77.      the data, it should be copied before any subsequent calls to these func-
  78.      tions overwrite it.  Only Internet network numbers are currently under-
  79.      stood.  Expecting network numbers to fit in no more than 32 bits is prob-
  80.      ably naive.
  81.  
  82. 4.2 Berkeley Distribution        June 4, 1993                                2
  83.